IQ
Contract IQ
User Guide
Contract Lifecycle
Management
A comprehensive guide to managing contracts end-to-end: from creation and obligation tracking through compliance monitoring, analytics, and AI-powered insights using the Contract IQ platform.
Prepared by: Contract IQ Platform Team Classification: Internal Use
v3.0
Last Updated
February 2026
Pages
10
Platform
Web App
Themes
Dark & Light
Backend
Supabase
About This Guide

This user guide covers all features and workflows within the Contract IQ application. It is designed for procurement professionals, contract managers, legal teams, and IT administrators who manage the full lifecycle of enterprise contracts.

Contract IQ provides a centralised platform for tracking contract portfolios, monitoring obligations, managing compliance risks, analysing spending patterns, and leveraging AI to answer contract-related queries in real time.

Key Capabilities
Contract Dashboard
Real-time portfolio overview with 4 KPI stat cards, a status doughnut chart, expiry timeline chart, and recent activity table.
Contract Register
Full contract list with multi-filter bar (status, type, department, search). Click any row for a slide-out detail panel with obligations, milestones, and amendments.
Obligation Tracking
Centralised view of all contract obligations with status tabs (All, Pending, In Progress, Completed, Overdue) and 3 KPI stat cards.
Compliance Monitoring
Auto-renewal alerts, notice period warnings, overdue obligation tracking, and a compliance score with contract-level risk assessment.
Analytics & Charts
Four interactive Chart.js visualisations: value by department, contract type distribution, supplier concentration, and monthly expiry timeline.
AI Assistant
Claude-powered AI panel for natural-language queries about contracts, obligations, compliance, and renewals. Streams responses in real time.
Notifications & Alerts
Bell icon with badge count, dropdown with contract expiry warnings, overdue obligations, and status change notifications.
Multi-App Platform
App Switcher in the sidebar header provides one-click navigation to Renewal IQ, Deal IQ, Perform IQ, Request IQ, and Admin IQ.
Table of Contents
How Do I… Quick Reference

Find the answer to common tasks instantly:

I want to…Go to
View my contract portfolioDashboard §3 (p.4)
Find a specific contractContracts §4.1 (p.5)
See contract obligationsObligations §6 (p.6)
Check compliance statusCompliance §7 (p.7)
View auto-renewal alertsCompliance §7.2 (p.7)
See notice period warningsCompliance §7.3 (p.7)
View contract amendmentsContract Detail §5.3 (p.5)
Switch to Light ModeGetting Started §2.2 (p.4)
I want to…Go to
View analytics chartsAnalytics §8 (p.8)
Filter contracts by departmentContracts §4.1 (p.5)
See top suppliers by valueAnalytics §8.3 (p.8)
Ask AI about my contractsAI Assistant §9.1 (p.9)
Check expiring contractsDashboard §3.2 (p.4)
View contract milestonesContract Detail §5.2 (p.5)
Switch to another IQ appGetting Started §2.3 (p.4)
Update my profileProfile §9.3 (p.9)
1. Quick-Start: Your First 10 Minutes

This walkthrough takes you from first login to a complete contract portfolio view. Follow these 6 steps and you will have explored all the core areas of Contract IQ end-to-end.

  1. Open Contract IQ — Launch the app in your browser. If authenticated, your contract data loads from Supabase automatically. If exploring, Demo Mode loads sample data (15+ contracts, 20+ obligations, milestones, and amendments) so you can try everything risk-free.
  2. Orient yourself — The sidebar (left, 280px) holds 5 navigation pages plus the AI Assistant. The topbar (top, 85px) has the search bar, notification bell, help button, and your profile avatar. The Dashboard loads by default.
  3. Review the Dashboard — Check the four KPI stat cards: Active Contracts, Expiring in 90d, Total Value, and Compliance Rate. Below, the Contracts by Status doughnut chart and Expiry Timeline bar chart give you a visual overview. The Recent Activity table at the bottom shows the latest contract events.
  4. Explore the Contracts page — Click Contracts in the sidebar. Use the filter bar to narrow by Status (Active, Expiring, Expired, Draft, Terminated, Under Review), Type (Software License, Cloud Services, etc.), or Department (IT, Finance, Sales, etc.). Click any row to open the slide-out Detail Panel.
  5. Check Obligations & Compliance — Navigate to Obligations to see all contract obligations with status tabs. Then visit Compliance for auto-renewal alerts, notice period warnings, and the compliance overview table with per-contract risk assessments.
  6. Explore Analytics & AI — Visit Analytics to see four interactive charts. Then click AI Assistant in the sidebar to open the side panel — enter your Claude API key and ask questions about your contracts in natural language.
Screenshot: Dashboard Overview
Capture the Dashboard showing 4 KPI stat cards, Contracts by Status doughnut chart, Expiry Timeline bar chart, and Recent Activity table.
i
Demo Mode: If you are not authenticated, Contract IQ loads a comprehensive set of demo data including contracts from Microsoft, AWS, Deloitte, Salesforce, SAP, Palo Alto Networks, Accenture, Workday, and more. This lets you explore all features without risk.
Common Workflows at a Glance

Three workflows you will use most often:

Monitor Expiring Contracts
Dashboard → check "Expiring in 90d" card → click Contracts → filter by "Expiring" status → click a row to see detail panel with full context.
Track Overdue Obligations
Obligations page → click "Overdue" tab → review each obligation's contract, type, due date, owner, and priority → follow up with responsible parties.
Compliance Risk Assessment
Compliance → review Auto-Renewal Alerts and Notice Period Warnings panels → check the Compliance Overview table for "At Risk" contracts.
Screenshot: Contract Detail Panel
Capture the slide-out detail panel showing contract metadata, obligations sub-table, milestones sub-table, and amendments sub-table.
2. Navigation & Getting Started

Contract IQ is accessed via your web browser. No installation is required. The application supports both authenticated (Supabase) and demo modes.

2.1 Layout Overview

The application uses a fixed sidebar (left, 280px) + topbar (top, 85px) layout. The sidebar holds 5 navigation pages (Dashboard, Contracts, Obligations, Compliance, Analytics) plus the AI Assistant. The topbar holds the global search bar, notification bell, help button (links to User Guides), and user profile avatar.

Screenshot: Full Application Layout
Annotated capture showing: (1) Sidebar with nav items and theme toggle, (2) Topbar with search, bell, help & profile, (3) Main content area, (4) App Switcher chevron.
2.2 Theme Toggle (Dark / Light Mode)

Click the moon/sun icon button at the bottom of the sidebar to switch between Dark Mode and Light Mode. Your preference is persisted in localStorage and applied on next visit. All charts, cards, badges, and panels update their colour palettes automatically.

2.3 App Switcher & Global Search

App Switcher: Click the IQ logo in the sidebar header to open a dropdown listing all IQ platform apps: Admin IQ, Contract IQ (current), Deal IQ, Perform IQ, Renewal IQ, and Request IQ. Click any tile to navigate to that application.

Global Search: The topbar search bar searches across contract names, supplier names, contract references, and obligation descriptions. Results appear in a dropdown with type badges (Contract or Obligation). Click any result to navigate to the matching page.

3. Contract Dashboard

The Dashboard is the default landing page, providing a real-time overview of your contract portfolio.

3.1 KPI Stat Cards

Four stat cards provide instant portfolio metrics:

CardWhat It ShowsWhy It Matters
Active ContractsCount of contracts with "Active" statusKnow the size of your active portfolio at a glance.
Expiring in 90dContracts expiring within 90 days (including Active contracts approaching end date)Identify contracts requiring renewal action.
Total ValueAggregate value across all contracts in GBPUnderstand total financial commitment.
Compliance RatePercentage of completed obligations out of total obligationsTrack your organisation's compliance health.
3.2 Dashboard Charts

Two Chart.js visualisations sit below the stat cards in a 2-column grid:

Contracts by Status — A doughnut chart breaking down contracts by status (Active, Expiring, Expired, Draft, Terminated, Under Review). The legend is positioned on the right. Each segment uses a gradient fill from the blue-to-purple palette.

Expiry Timeline — A bar chart showing the count of contracts expiring in each of the next 6 months. Helps identify months with high renewal workload.

3.3 Recent Activity

A table at the bottom lists the most recent contract events with columns for Date, Contract (reference), Supplier, Event (description of what happened), and Status (colour-coded badge). Events include contract expiry warnings, auto-renewal notice periods, draft creations, amendment approvals, obligation completions, and status changes.

4. Contracts Register

The Contracts page is your master register of all contracts. It features a multi-criteria filter bar at the top and a clickable data table below.

4.1 Filter Bar

Four filter controls allow you to narrow the contract list:

FilterOptions
StatusAll Statuses, Active, Expiring, Expired, Draft, Terminated, Under Review
TypeAll Types, Software License, Cloud Services, Professional Services, Security, Information Services, Marketing Services
DepartmentAll Departments, IT, Finance, Sales, Operations, HR, Legal, Marketing
SearchFree-text search across contract name, supplier, and contract reference
4.2 Contracts Table

Columns: Ref, Contract Name, Supplier, Type, Department, Value (GBP), End Date, and Status (colour-coded badge). Click any row to open the slide-out Contract Detail Panel.

Screenshot: Contracts Page
Capture showing: (1) Filter bar with Status, Type, Department dropdowns and search input, (2) Contracts table with clickable rows.
4.3 Contract Status Badges
Active
Expiring
Expired
Draft
Terminated
Under Review
5. Contract Detail Panel

Clicking any row in the Contracts table opens a 620px-wide slide-out panel on the right. The panel provides a comprehensive view of a single contract, organised into four sections.

5.1 Contract Metadata

A 2-column grid at the top displays 12 key fields:

FieldDescription
SupplierThe vendor or service provider name.
StatusCurrent contract status (colour-coded badge).
TypeContract type (Software License, Cloud Services, etc.).
DepartmentBusiness unit that owns the contract.
Total ValueFull contract value in GBP.
Annual ValuePer-year contract value.
Start / End DateContract term dates.
OwnerPerson responsible for the contract.
Auto-RenewalYes/No — whether the contract auto-renews.
Notice PeriodDays of notice required before expiry (e.g., 90 days).
PaymentPayment terms and frequency (e.g., "Net 30 / Annual").
5.2 Obligations & Milestones Sub-Tables

Obligations: Lists all obligations linked to this contract with columns for Obligation, Type (Reporting, Audit, SLA, Deliverable, Payment, Compliance), Due Date, and Status (badge). Types include Reporting, Audit, SLA, Deliverable, Payment, and Compliance.

Milestones: Lists key contract milestones with columns for Milestone, Type (Start, Review, Renewal, Deliverable, Termination), Date, and Status (Completed, Upcoming).

5.3 Amendments Sub-Table

Lists all contract amendments with columns for Amendment (title), Type (Scope Change, Value Change, Term Extension, SLA Modification, Term Change, Compliance), Old Value, New Value, and Status (Approved, Pending). This provides a clear audit trail of every change made to the contract.

i
Close the Panel: Click the X button in the panel header, or click the overlay backdrop, to close the detail panel and return to the Contracts table.
6. Obligations

The Obligations page provides a centralised view of all contract obligations across your portfolio. It tracks what needs to be done, by whom, and by when.

6.1 Obligation Stat Cards

Three stat cards at the top (displayed in a 3-column grid) provide instant obligation metrics:

CardWhat It ShowsWhy It Matters
Total ObligationsCount of all obligations across all contractsUnderstand your total obligation footprint.
OverdueCount of obligations past their due dateIdentify obligations requiring immediate action.
Completion RatePercentage of completed obligations out of totalTrack overall delivery performance.
6.2 Status Filter Tabs

A row of filter tab buttons allows you to quickly switch between obligation views:

All
Pending
In Progress
Completed
Overdue

The active tab is highlighted with a gradient border. Clicking a tab instantly filters the table below to show only obligations matching that status.

6.3 Obligations Table

The obligations table displays all filtered obligations with 7 columns:

ColumnDescription
ObligationDescription of the obligation (e.g., "Deliver monthly usage report").
ContractThe parent contract name (resolved from contract reference).
TypeObligation category: Reporting, Audit, SLA, Deliverable, Payment, or Compliance.
Due DateDate by which the obligation must be fulfilled.
OwnerResponsible party (can be the supplier or an internal contact).
PriorityColour-coded badge: High (red), Medium (amber), Low (blue).
StatusColour-coded badge: Pending, In Progress, Completed, or Overdue.
Screenshot: Obligations Page
Capture showing the 3 stat cards, filter tabs (with "All" active), and the full obligations table with priority and status badges.
i
Obligation Types Explained: Reporting = periodic reports the supplier must provide. Audit = security/financial audits. SLA = service level commitments. Deliverable = project milestones or work products. Payment = financial obligations. Compliance = regulatory or policy requirements.
!
Overdue Obligations: Overdue items directly impact your Compliance Score on the Dashboard and the Compliance page. Resolving overdue obligations should be a priority to maintain a healthy compliance rating.
7. Compliance

The Compliance page combines auto-renewal alerts, notice period warnings, and a per-contract compliance overview into a single view. It helps you proactively manage contract risk.

7.1 Compliance Stat Cards

Four stat cards provide compliance metrics:

CardWhat It ShowsWhy It Matters
Auto-Renewal ContractsCount of contracts with auto-renewal enabledKnow which contracts will auto-renew if no action is taken.
Notice Period WarningsContracts approaching their notice period deadline (within 60 days)Avoid missing critical notice windows.
Overdue ObligationsCount of obligations past their due dateIdentify compliance failures requiring remediation.
Compliance ScorePercentage of completed obligations (same as Dashboard compliance rate)Overall compliance health indicator.
7.2 Auto-Renewal Alerts Panel

A panel listing all contracts that have auto-renewal enabled and are expiring within the next 12 months. Each alert card shows the contract name, supplier, expiry date, days remaining, and notice period. Urgency is indicated by a coloured left border:

Red border = expires within 90 days
Immediate action required — review auto-renewal terms.
Amber border = expires within 12 months
Plan ahead — decide whether to renew, renegotiate, or terminate.
7.3 Notice Period Warnings Panel

Lists contracts where the notice period deadline is approaching (within 90 days of the deadline) or has already passed. The notice deadline is calculated as: End Date minus Notice Period (in days). Three urgency levels:

PASSED
Notice deadline has passed
0–30 Days
Urgent — notice deadline imminent
30–90 Days
Advisory — start planning
7.4 Compliance Overview Table

A table listing all non-terminated, non-expired, non-draft contracts with their compliance posture:

ColumnDescription
ContractContract name.
SupplierSupplier or vendor name.
End DateContract end date.
Notice PeriodRequired notice period in days.
Auto-Renewal"Yes" (blue badge) or "No" (purple badge).
Overdue ItemsCount of overdue obligations — 0 (green badge) or n (red badge).
Status"Compliant" (green) if zero overdue items, "At Risk" (amber) if any overdue.
Screenshot: Compliance Page
Capture showing the 4 stat cards, Auto-Renewal Alerts panel, Notice Period Warnings panel, and Compliance Overview table.
8. Analytics

The Analytics page provides four interactive Chart.js visualisations that help you understand spending patterns, contract composition, supplier concentration, and future expiry forecasts. Charts are displayed in a 2×2 grid layout.

8.1 Value by Department

A horizontal bar chart showing the total contract value (in £M) per department, sorted from highest to lowest. This reveals which departments hold the greatest financial exposure and helps prioritise procurement oversight.

8.2 Contract Type Distribution

A doughnut chart breaking down contracts by type: Software License, Cloud Services, Professional Services, Security, Information Services, and Marketing Services. The legend is positioned on the right with point-style indicators. Hover any segment for a tooltip showing the exact count.

Value by Department
Horizontal bar chart. Aggregates total contract value per department. Tooltip shows £M values. Y-axis labels show department names. X-axis shows value in £M.
Contract Type Distribution
Doughnut chart with 65% cutout. Segments use blue-to-purple gradients. Shows count per contract type. Useful for portfolio diversification analysis.
Supplier Concentration (Top 8)
Vertical bar chart ranking the 8 highest-value suppliers. Highlights vendor dependency risks. Labels truncated at 12 characters. Values in £M.
Monthly Expiry Timeline
Bar chart showing the count of contracts expiring in each of the next 12 months. Helps forecast renewal workload and resource allocation needs.
Screenshot: Analytics Page
Capture showing all four charts in the 2x2 grid layout: Value by Department, Contract Type Distribution, Supplier Concentration, and Monthly Expiry Timeline.
i
Theme-Aware Charts: All charts automatically adjust their colours, grid lines, segment borders, and tooltip styles when switching between Dark Mode and Light Mode. Chart gradients shift from the blue-purple neon palette (dark) to the lavender-lilac palette (light).
8.5 Chart Interaction

All charts support the following interactions:

InteractionWhat Happens
Hover a bar/segmentTooltip appears with the exact value or count for that data point.
Hover a doughnut segmentSegment lifts outward (12px offset) and tooltip shows the label and value.
Click a legend itemToggles that dataset on/off in the chart.
!
Lazy Loading: Analytics charts are initialised on first visit to the Analytics page (not on app load). This means the first visit may take a moment to render. Subsequent visits are instant as the charts remain in memory.
9. AI Assistant, Profile & Cross-App Workflow
9.1 AI Assistant Panel

Click AI Assistant in the sidebar (or press Ctrl+Shift+I) to open a 420px-wide slide-out panel on the right. The AI Assistant is powered by Claude (claude-sonnet-4-5-20250929) and streams responses in real time.

9.2 Setting Up the AI Assistant
  1. Open the panel — Click AI Assistant in the sidebar or use Ctrl+Shift+I.
  2. Enter your API key — Paste your Claude API key (starting with sk-ant-api03-...) and click Save Key. The key is stored locally (Base64-encoded in localStorage).
  3. Ask a question — Type a question about your contracts in the text area and press Enter or click the send button. The AI has access to your full contract data, obligations, and can answer questions about compliance, renewals, and more.
  4. View streamed response — Responses stream in token-by-token. The AI automatically receives your current contract data as context, enabling informed answers.

Chat History: The last 50 messages are persisted in localStorage (key: iq_ai_chat_contract) and restored when you reopen the panel. Click the trash icon in the header to clear the conversation.

Data Context: The AI receives your full CONTRACTS array and a subset of OBLIGATIONS as system context, enabling it to answer questions like "Which contracts are expiring next month?" or "What obligations are overdue for the Microsoft 365 contract?"

i
API Key Security: Your API key is stored locally in your browser only. It is never sent to the Contract IQ server. To clear it, click "Clear key" in the AI panel setup area.
9.3 User Profile & Multi-Org

Click the user avatar in the topbar to open the Profile Popover. Edit your name, position, and organisation. If you belong to multiple organisations, a dropdown lets you switch context — all data is scoped to the selected organisation.

Invite Code: Share this code with colleagues so they can join your organisation. Copy it using the clipboard button next to the code display.

Sign Out: The gradient sign-out button at the bottom of the popover ends your session and redirects to the Renewal IQ platform login page.

9.4 Notifications & Help

Notification Bell: The bell icon displays a gradient badge with the count of active notifications. Click it for a dropdown showing contract expiry warnings, overdue obligations, contract status changes, and draft approvals. Each notification has a title and description.

Help Button: The ? icon opens a dropdown linking to the User Guides page (opens in a new tab via site-user-guides.html).

9.5 Cloud Sync (Supabase)

When authenticated, all data syncs from Supabase (PostgreSQL) including contracts, obligations, milestones, and amendments — scoped by organisation via Row-Level Security (RLS). Four tables are loaded: contracts, contract_obligations, contract_milestones, and contract_amendments. In Demo Mode, sample data is loaded into the browser session only.

9.6 Cross-App Navigation

The App Switcher (click the IQ logo in the sidebar header) provides direct links to all IQ platform applications:

Admin IQ
Platform administration
Contract IQ
Contract lifecycle (current)
Deal IQ
Procurement deal intelligence
Perform IQ
Supplier performance tracking
Renewal IQ
Contract renewals & approvals
Request IQ
Procurement requests & intake
10. FAQ & Troubleshooting

Quick answers to the most common questions:

Q1: I just logged in and see no data. Where are my contracts?
If you are logging in for the first time, your organisation's database may be empty. Contracts are loaded from Supabase when authenticated. If you expected to see existing data, check that you are signed into the correct organisation via the Profile Popover. In demo mode, sample data is loaded automatically.
Q2: What is the difference between the Dashboard "Compliance Rate" and the Compliance page "Compliance Score"?
They are the same metric — both show the percentage of completed obligations out of total obligations. The Dashboard card is labelled "Compliance Rate" and the Compliance page card is labelled "Compliance Score". They will always display the same value.
Q3: Why does the "Expiring in 90d" count differ from the Contracts page "Expiring" filter?
The Dashboard "Expiring in 90d" stat card counts contracts with an "Expiring" status plus any "Active" contracts whose end date is within 90 days. The Contracts page "Expiring" filter only shows contracts explicitly set to "Expiring" status. The Dashboard metric is more comprehensive.
Q4: How are notice period warnings calculated?
The notice deadline is calculated as: End Date minus Notice Period (days). For example, a contract ending on 2026-06-30 with a 90-day notice period has a deadline of 2026-04-01. If today is within 90 days of that deadline (or it has passed), it appears as a warning on the Compliance page.
Q5: Can I search for obligations from the topbar?
Yes. The topbar search bar searches across both contract data (name, supplier, reference) and obligation descriptions. Results are shown in a dropdown with type badges indicating "Contract" or "Obligation". Clicking an obligation result navigates to the Obligations page.
Q6: What does the "At Risk" compliance status mean?
A contract is marked "At Risk" in the Compliance Overview table if it has one or more overdue obligations. "Compliant" means all obligations are either completed, pending, or in progress (none overdue). Resolving overdue obligations will move the contract back to "Compliant" status.
Q7: How do I set up the AI Assistant?
Click AI Assistant in the sidebar, enter your Claude API key in the setup area, and click Save Key. Your key is stored locally in your browser. Once saved, you can ask natural-language questions about your contracts. The AI receives your full contract and obligation data as context.
Q8: Is my AI API key sent to the Contract IQ server?
No. Your API key is stored locally in your browser (localStorage) and sent directly to the Anthropic API from your browser. Contract IQ does not have a backend proxy for AI calls — all communication is client-side via the Anthropic Messages API.
Q9: What is the difference between Dark Mode and Light Mode functionally?
There is no functional difference — both modes offer identical features. The choice is purely visual preference. Your theme selection is saved in localStorage (key: iq-theme) and persists across sessions. All charts, badges, cards, and panels adapt their colour palette automatically.
Q10: The Analytics charts are not showing. What's wrong?
Analytics charts are lazy-loaded — they initialise only when you first visit the Analytics page. If charts do not appear, try refreshing the page. Also ensure Chart.js has loaded correctly (check for network errors in the browser console). The CDN URL is cdn.jsdelivr.net.
Q11: How do I switch between organisations?
Click your avatar (top-right) to open the Profile Popover. If you belong to multiple organisations, the Organisation field becomes a dropdown. Select a different organisation and click Save. The page will reload with data scoped to the selected organisation. This calls the Supabase switch_organisation RPC function.
Q12: How do I invite a colleague to my organisation?
Open the Profile Popover (click your avatar). The Invite Code section shows a unique code for your organisation. Click the copy button to copy it to your clipboard, then share it with your colleague. They can enter this code during sign-up or in their own Profile Popover to join your organisation.
IQ Platform Applications
Admin IQ
Platform admin
Contract IQ
Contract lifecycle
Deal IQ
Deal intelligence
Perform IQ
Supplier performance
Renewal IQ
Contract renewals
Request IQ
Procurement requests